RESTful API এবং JSON Parsing

RESTful API এবং JSON Parsing iOS অ্যাপ্লিকেশন ডেভেলপমেন্টের একটি গুরুত্বপূর্ণ অংশ, কারণ এগুলোর মাধ্যমে অ্যাপ্লিকেশন ইন্টারনেট থেকে ডেটা ফেচ করতে পারে এবং ডাইনামিক কন্টেন্ট প্রদর্শন করতে পারে। RESTful API হল একটি ওয়েব সার্ভিসের মাধ্যমে ডেটা বা রিসোর্স অ্যাক্সেস এবং ম্যানেজ করার পদ্ধতি। JSON Parsing ব্যবহার করে এই ডেটা অ্যাপ্লিকেশনে ব্যবহারের উপযোগী করা হয়।

RESTful API কী?

• RESTful API (Representational State Transfer) হলো এমন একটি API যা HTTP প্রোটোকলের মাধ্যমে ডেটা রিকোয়েস্ট এবং রেসপন্স করে। এটি GET, POST, PUT, এবং DELETE এর মতো HTTP মেথড ব্যবহার করে ডেটা বা রিসোর্স ম্যানিপুলেট করে।
• GET: ডেটা রিড করার জন্য।
• POST: নতুন ডেটা ক্রিয়েট করার জন্য।
• PUT: বিদ্যমান ডেটা আপডেট করার জন্য।
• DELETE: ডেটা ডিলিট করার জন্য।

JSON (JavaScript Object Notation)

• JSON হলো একটি ডেটা ফরম্যাট যা API রেসপন্সের মাধ্যমে ডেটা পাঠানো এবং রিসিভ করার জন্য ব্যবহৃত হয়। এটি একটি লাইটওয়েট এবং হিউম্যান-রিডেবল ফরম্যাট, যা ডেটা স্ট্রাকচার হিসেবে সহজে পাস করা যায়।
• উদাহরণ JSON:

{
    "name": "John",
    "age": 30,
    "skills": ["Swift", "Objective-C", "Python"]
}

iOS-এ RESTful API এবং JSON Parsing কিভাবে কাজ করে?

iOS অ্যাপে URLSession API ব্যবহার করে RESTful API কল করা হয় এবং JSON ডেটা পার্স করা হয়। Codable প্রোটোকল Swift-এ JSON ডেটা মডেল করার জন্য একটি শক্তিশালী টুল।

উদাহরণ: RESTful API কল এবং JSON Parsing

ধরা যাক, আমরা একটি API থেকে ইউজারদের ডেটা ফেচ করবো এবং সেগুলো অ্যাপ্লিকেশনে দেখাবো। API URL: "https://jsonplaceholder.typicode.com/users"

Step ১: JSON Data Model তৈরি করা

API থেকে প্রাপ্ত JSON ডেটার জন্য একটি ডেটা মডেল তৈরি করতে হবে। আমরা Codable প্রোটোকল ব্যবহার করবো যাতে JSON সহজে মডেল ক্লাসে ম্যাপ করা যায়।

struct User: Codable {
    let id: Int
    let name: String
    let username: String
    let email: String
}

Step ২: API কল এবং ডেটা ফেচ করা

API কল করার জন্য URLSession ব্যবহার করা হবে:

func fetchUsers() {
    // API URL তৈরি করা
    guard let url = URL(string: "https://jsonplaceholder.typicode.com/users") else { return }
    
    // URLSession দিয়ে ডেটা টাস্ক তৈরি করা
    let task = URLSession.shared.dataTask(with: url) { data, response, error in
        // যদি কোনো ত্রুটি থাকে
        if let error = error {
            print("Error fetching users: \(error)")
            return
        }
        
        // ডেটা চেক করা
        guard let data = data else {
            print("No data received")
            return
        }
        
        // JSON ডেটা ডিকোড করা
        do {
            let users = try JSONDecoder().decode([User].self, from: data)
            print("Fetched Users: \(users)")
            // UI আপডেটের জন্য মেইন থ্রেড ব্যবহার করা
            DispatchQueue.main.async {
                // UI আপডেট কোড এখানে
            }
        } catch {
            print("Error decoding JSON: \(error)")
        }
    }
    
    // টাস্ক শুরু করা
    task.resume()
}

• URLSession.shared.dataTask(with:): API কল করে ডেটা রিসিভ করার জন্য ব্যবহার করা হয়।
• JSONDecoder ব্যবহার করে ডেটাকে User মডেল অবজেক্টে ম্যাপ করা হয়।
• DispatchQueue.main.async ব্যবহার করে UI আপডেট করা হয়, কারণ ডেটা ফেচিং ব্যাকগ্রাউন্ড থ্রেডে চলে এবং UI আপডেট মেইন থ্রেডে করতে হয়।

Step ৩: API রেসপন্স হ্যান্ডলিং এবং UI আপডেট করা

JSON ডেটা ডিকোড করার পর ডেটা সঠিকভাবে UI-তে আপডেট করতে হবে। ধরুন, আমরা একটি UITableView ব্যবহার করছি ইউজারদের নাম দেখানোর জন্য:

class ViewController: UIViewController, UITableViewDataSource {
    @IBOutlet weak var tableView: UITableView!
    
    var users: [User] = []
    
    override func viewDidLoad() {
        super.viewDidLoad()
        tableView.dataSource = self
        fetchUsers()
    }
    
    func fetchUsers() {
        guard let url = URL(string: "https://jsonplaceholder.typicode.com/users") else { return }
        
        let task = URLSession.shared.dataTask(with: url) { data, response, error in
            if let error = error {
                print("Error fetching users: \(error)")
                return
            }
            
            guard let data = data else {
                print("No data received")
                return
            }
            
            do {
                let fetchedUsers = try JSONDecoder().decode([User].self, from: data)
                DispatchQueue.main.async {
                    self.users = fetchedUsers
                    self.tableView.reloadData()
                }
            } catch {
                print("Error decoding JSON: \(error)")
            }
        }
        
        task.resume()
    }
    
    // UITableView Data Source Methods
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return users.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "cellIdentifier", for: indexPath)
        cell.textLabel?.text = users[indexPath.row].name
        return cell
    }
}

API কল করার সময় প্রয়োজনীয় বিষয়গুলো

1. URL Encoding: API রিকোয়েস্ট করার সময় সঠিকভাবে URL এনকোড করা প্রয়োজন যাতে স্পেশাল ক্যারেক্টারগুলো সঠিকভাবে ব্যবহৃত হয়।
2. Error Handling: API কল করার সময় ত্রুটি (Error) হ্যান্ডল করা প্রয়োজন।
3. Asynchronous Call: URLSession asynchronous কাজ করে, তাই ডেটা রিসিভ হওয়ার পরে UI-তে পরিবর্তন আনতে DispatchQueue.main.async ব্যবহার করতে হয়।
4. SSL ও নিরাপত্তা: API ব্যবহার করার সময় নিশ্চিত করুন যে API HTTPS প্রোটোকলের মাধ্যমে সুরক্ষিত। plist ফাইলে সঠিক সেটিংস নিশ্চিত করা উচিত।

POST Request দিয়ে ডেটা পাঠানো

func postData() {
    guard let url = URL(string: "https://jsonplaceholder.typicode.com/posts") else { return }
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    
    // JSON ডেটা তৈরি
    let parameters: [String: Any] = [
        "title": "New Post",
        "body": "This is the content of the post",
        "userId": 1
    ]
    
    do {
        request.httpBody = try JSONSerialization.data(withJSONObject: parameters, options: [])
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
        
        let task = URLSession.shared.dataTask(with: request) { data, response, error in
            if let error = error {
                print("Error posting data: \(error)")
                return
            }
            
            if let response = response as? HTTPURLResponse {
                print("Response status code: \(response.statusCode)")
            }
        }
        task.resume()
    } catch {
        print("Error serializing JSON: \(error)")
    }
}

উপসংহার

• RESTful API এর মাধ্যমে iOS অ্যাপে ডাইনামিক ডেটা ফেচ এবং ম্যানেজ করা যায়।
• JSON Parsing Swift-এ সহজ এবং কার্যকর, বিশেষ করে Codable প্রোটোকল ব্যবহার করে।
• URLSession API কল এবং ডেটা রিসিভ করার জন্য ব্যবহার করা হয়, যা অ্যাসিনক্রোনাস এবং মেইন থ্রেডে UI আপডেট করার সুযোগ দেয়।